# Micro HDMI

***Copyright © Quectel Wireless Solutions Co., Ltd. 2026. All rights reserved.***

---

本文档介绍 **Quectel Pi M1 / L1 Debian** 系统下 **Micro HDMI** 显示接口的连接、识别、显示设置、触摸使用和音视频播放方法。本文以外接 Micro HDMI 显示屏为例进行说明。

# 概述

**Micro HDMI** 是常用的音视频输出接口，适用于桌面显示、媒体播放、调试操作、工业看板和人机交互终端等场景。Quectel Pi M1 / L1 提供 1 路 Micro HDMI 2.0 接口，可连接 Micro HDMI 显示器进入 Debian 桌面环境。M1 默认进入 GNOME 桌面，L1 默认进入 Weston 桌面。

Quectel Pi M1 / L1 显示相关接口如下表所示：

| **接口** | **说明** |
| --- | --- |
| Micro HDMI | 1 路 Micro HDMI 接口，Micro HDMI 2.0。显示模式由系统、显示器 EDID 和线缆共同协商。 |
| 触摸 | 若 Micro HDMI 屏幕支持触摸功能，通常需要额外连接 USB 触摸线。 |

# 硬件接口

## Micro HDMI屏幕连接

将 Micro HDMI 显示屏连接到开发板的 **Micro HDMI** 接口，并确认显示屏供电正常、Micro HDMI 线缆连接牢固。

M1 / L1 Micro HDMI 屏幕连接示意图：

```{image} images/image_Z4MbbhDVwoeVZ6xWhQccLsrSnte.webp
:width: 1736px
:height: 910px
```

连接注意事项：

1. 连接 Micro HDMI 显示屏前，建议先关闭开发板电源。

2. 确认 Micro HDMI 线缆方向正确，避免接口受力。

3. 确认显示器已经切换到对应 Micro HDMI 输入源。

4. 若使用带触摸功能的 Micro HDMI 屏幕，需要同时连接屏幕的 USB 触摸线。

## 触摸连接

若 Micro HDMI 屏幕支持触摸功能，请将屏幕的 USB 触摸接口连接到开发板的 USB Host 接口。系统识别触摸设备后，可直接在 Debian 桌面中进行点击、拖动和窗口操作。

M1 / L1 Micro HDMI 触摸连接示意图：

```{image} images/image_I4ZtbgoyEoVK2wxwuzqcRNVinsk.webp
:width: 1646px
:height: 830px
```

# 快速开始

1. 关闭开发板电源。

2. 将 Micro HDMI 线缆连接到开发板和 Micro HDMI 显示屏。

3. 打开 Micro HDMI 显示屏电源，并选择对应 Micro HDMI 输入源。

4. 给开发板上电。

5. 系统启动后进入 Debian 桌面。M1 进入 GNOME 桌面，L1 进入 Weston 桌面。

6. 如需确认系统状态，可在开发板终端执行：

```bash
hostname -I
cat /sys/class/drm/card0-Micro HDMI-A-1/status
cat /sys/class/drm/card0-Micro HDMI-A-1/modes
```

M1 Micro HDMI 桌面显示效果：

```{image} images/image_QyCebZYkTodpppxwF2tcRcEUnzg.webp
:width: 1280px
:height: 800px
```

L1 Micro HDMI 桌面显示效果：

```{image} images/image_UW72bmMKMoSN1Xx3RJocOJ1ZnWg.webp
:width: 760px
:height: 427px
```

# 功能使用（GNOME）

以下功能基于 M1 GNOME 桌面环境。

## 触摸功能

连接 Micro HDMI 屏幕的 USB 触摸线后，可直接在 Debian 桌面中使用触摸功能。若触摸无响应，请优先检查 USB 触摸线是否连接到 USB Host 接口，并重新插拔后查看系统是否识别到输入设备：

```bash
lsusb
cat /proc/bus/input/devices
```

## 视频播放功能的使用方法

可先将测试视频推送到开发板的 `Videos` 目录：

```bash
adb push /home/q/work/temp/test-1.mp4 /home/q/Videos/m1-Micro HDMI-display-test.mp4
```

**可视化界面的视频播放功能**：在 Debian 桌面中，可通过文件管理器进入 `Videos` 目录，双击 `m1-Micro HDMI-display-test.mp4` 进行播放。

```{image} images/image_St3BbxYfpo9qO2xoQOCcbfnknHd.webp
:width: 1280px
:height: 800px
```

```{image} images/image_YhNTbyRT4oSablxvmM0c6DCnn9e.webp
:width: 1280px
:height: 800px
```

**GStreamer命令行操作的视频播放功能**：在使用命令行播放视频时，可输入以下命令。

```bash
gst-launch-1.0 playbin uri=file:///home/q/Videos/m1-Micro HDMI-display-test.mp4
```

以下为 GStreamer 命令行播放视频的效果图。

```{image} images/image_FC4ab07PcoNRAHxtMs3cn7PxnMg.webp
:width: 1280px
:height: 800px
```

## 音频播放功能的使用方法

可先将测试音频推送到开发板的 `Music` 目录：

```bash
adb push /home/q/work/temp/test.mp3 /home/q/Music/m1-Micro HDMI-audio-test.mp3
```

**可视化界面的音频播放功能**：在 Debian 桌面中，可通过文件管理器进入 `Music` 目录，双击 `m1-Micro HDMI-audio-test.mp3` 进行播放。

```{image} images/image_ScnHbjkj9oLAktxdp5EcIWA3ngh.webp
:width: 1280px
:height: 800px
```

```{image} images/image_C1Deb4HwQoGdtyxSVNDcRTB2nRg.webp
:width: 1280px
:height: 800px
```

**GStreamer命令行操作的音频播放功能**：在使用命令行播放音频时，可输入以下命令。

```bash
gst-launch-1.0 playbin uri=file:///home/q/Music/m1-Micro HDMI-audio-test.mp3
```

以下为 GStreamer 命令行播放音频的效果图。

```{image} images/image_P65dbotifow2lhxZ5S5cPggDnpd.webp
:width: 1280px
:height: 800px
```

## 音频输出检查

若 Micro HDMI 视频播放正常但没有声音，可先查看音频服务和默认输出设备：

```bash
pactl info
```

如果系统中存在多个音频输出设备，可在 GNOME 桌面右上角快捷设置中切换输出设备，或进入 **Settings > Sound** 查看音频输出配置。

```{image} images/image_FtIubdbEroQKt9xOMcncEbednwe.webp
:width: 1280px
:height: 800px
```

# 功能使用（Weston）

以下功能基于 L1 Weston 桌面环境。

## 触摸功能

连接 Micro HDMI 屏幕的 USB 触摸线后，可直接在 Debian 桌面中使用触摸功能。若触摸无响应，请优先检查 USB 触摸线是否连接到 USB Host 接口，并重新插拔后查看系统是否识别到输入设备：

```bash
lsusb
cat /proc/bus/input/devices
```

## 视频播放功能的使用方法

可先将测试视频推送到开发板的 `Videos` 目录：

```bash
adb push /home/q/work/temp/test-1.mp4 /home/q/Videos/l1-Micro HDMI-display-test.mp4
```

**GStreamer命令行操作的视频播放功能**：在使用命令行播放视频时，可输入以下命令。

```bash
gst-launch-1.0 playbin uri=file:///home/q/Videos/l1-Micro HDMI-display-test.mp4
```

以下为 GStreamer 命令行播放视频的效果图。

```{image} images/image_NTMmbS0zuo4P0NxTpw6czj88n6b.webp
:width: 1280px
:height: 800px
```

## 音频播放功能的使用方法

可先将测试音频推送到开发板的 `Music` 目录：

```bash
adb push /home/q/work/temp/test.mp3 /home/q/Music/l1-Micro HDMI-audio-test.mp3
```

**GStreamer命令行操作的音频播放功能**：在使用命令行播放音频时，可输入以下命令。

```bash
gst-launch-1.0 playbin uri=file:///home/q/Music/l1-Micro HDMI-audio-test.mp3
```

以下为 GStreamer 命令行播放音频的效果图。

```{image} images/image_KTYNbfrdFoM7oqxqldzcg27Tngc.webp
:width: 1119px
:height: 511px
```

# 进阶功能

## Micro HDMI屏幕热插拔

Micro HDMI 支持热插拔。系统运行过程中插入 Micro HDMI 显示屏后，系统通常会自动识别显示器并输出画面。

热插拔使用方法：

1. 在系统运行状态下，将 Micro HDMI 显示屏连接到开发板的 Micro HDMI 接口。

2. 等待系统自动检测显示设备。

3. 若画面未自动显示：M1 可进入 **Settings > Displays** 查看显示器是否被识别；L1 可通过 `/sys/class/drm/card0-Micro HDMI-A-1/status` 查看显示器是否被识别。

4. 如需断开 Micro HDMI 显示屏，可直接拔出 Micro HDMI 线缆。

## 命令行状态查看

常用排查命令如下：

```bash
# 查看 Micro HDMI 连接状态和支持的显示模式
cat /sys/class/drm/card0-Micro HDMI-A-1/status
cat /sys/class/drm/card0-Micro HDMI-A-1/modes

# 查看系统日志中的显示相关信息
journalctl -b | grep -Ei 'Micro HDMI|drm|display|edid'

# 查看音频默认输出设备
pactl info
```

# 应用场景

- **媒体娱乐终端**：通过 Micro HDMI 显示屏播放视频、音乐或展示图片。

- **工业数据可视化平台**：用于显示设备状态、传感器数据、仪表盘和告警信息。

- **智能交互终端**：搭配触摸 Micro HDMI 屏幕实现本地菜单、控制面板和人机交互界面。

- **开发调试显示终端**：连接常见 Micro HDMI 显示器后，可直接查看 Debian 桌面和调试信息。

# 疑难解答

| **现象** | **可能原因** | **处理方法** |
| --- | --- | --- |
| 开机后黑屏 | 显示器未上电、输入源选择错误、Micro HDMI 线缆未插紧，或系统未完成启动 | 检查显示器供电和输入源；重新插拔 Micro HDMI 线缆；通过串口或 ADB 查看系统是否正常启动。 |
| 热插拔后无画面 | 系统未及时识别 Micro HDMI 设备，或显示器 EDID 读取异常 | 等待数秒后查看连接状态：M1 进入 **Settings > Displays** 查看显示器；L1 执行 `cat /sys/class/drm/card0-Micro HDMI-A-1/status`。必要时重新插拔 Micro HDMI 线缆或重启系统。 |
| 分辨率异常 | 显示器 EDID 识别异常、线缆质量不佳，或当前显示器不支持系统协商的模式 | 更换 Micro HDMI 线缆或显示器；M1 进入 **Settings > Displays** 手动选择可用分辨率；L1 执行 `cat /sys/class/drm/card0-Micro HDMI-A-1/modes` 查看当前可用显示模式。 |
| 屏幕花屏或闪烁 | Micro HDMI 线缆质量不佳、接口接触不良或受到干扰 | 更换质量更好的 Micro HDMI 线缆；确认接口插紧；避免线缆靠近强干扰源。 |
| 触摸无响应 | USB 触摸线未连接、接错接口，或系统未识别输入设备 | 检查 USB 触摸线连接；执行 `lsusb` 和 `cat /proc/bus/input/devices` 查看触摸设备是否被识别。 |
| 视频无法播放 | 视频编码不受当前播放器支持，或文件路径错误 | 确认视频文件已存在于 `/home/q/Videos/`；M1 尝试使用 GNOME 视频播放器或 GStreamer；L1 尝试使用 GStreamer 播放常见 H.264 MP4 测试视频。 |
| 视频有画面无声音 | 音频输出设备选择错误、音量被静音，或显示器不支持当前音频输出 | M1 检查右上角声音设置，进入 **Settings > Sound** 切换输出设备；执行 `pactl info` 查看默认输出设备。L1 确认音频设备已连接，并确认音量未静音。 |